home *** CD-ROM | disk | FTP | other *** search
/ The Games Machine 136 / XENIATGM136.iso / Shareware / Dragon UnPACKer 4.22a / dup422-setup.exe / {app} / utils / hrf_specs.txt < prev    next >
Text File  |  2001-02-04  |  10KB  |  239 lines
  1. HyperRipper File Format (.HRF/HRFi) - Release I                        Freeware
  2. (c)Copyright 1999-2001 Alex Devilliers / Dragon Software             04-02-2001
  3. ===============================================================================
  4.  
  5.   What is HyperRipper File Format ?
  6.   ---------------------------------
  7.   
  8. This file format is the format used by the Dragon UnPACKer's HyperRipper to
  9. store Offsets/Size/Filenames of found data.
  10.  
  11. Ex: If the HyperRipper found a RIFF/WAVE 'file' into Example.Dat at offset 32
  12.     and size of 32560.
  13.     The .HRF file will store this offset/size in order that the user will be
  14.     able to reopen this file (Example.Dat) in Dragon UnPACKer without having to
  15.     redo the HyperRipper search.
  16.     
  17. You need at least Dragon UnPACKer v4.00.32 Beta to read .HRF files.
  18. From Dragon UnPACKer v4.00.38 Beta, there is a new .HRF file format supported
  19. (version 1). Before this version, only HRF file format version 0 was supported.
  20. Dragon UnPACKer v4.00.38 Beta and up have read & write support for both version
  21. 1 and version 0.
  22.  
  23.  
  24.   Some information:
  25.   -----------------
  26.   
  27.      LONG is a 4 Bytes long signed value (-2M to 2M)
  28.   INTEGER is a 2 Bytes long signed value (-32k to 32k)
  29.      BYTE is a 1 Byte long unsigned value (0 to 255)
  30.    STRING is a Character Array
  31.   Version is an array of 2 Bytes (first is Major version, second is Minor)
  32.   
  33.   Strings can be null terminated but are often padded with spaces (32/&H20).
  34.  
  35.  
  36.   Global file format:
  37.   -------------------
  38.  
  39.   For HRFi version 0:
  40.   
  41.   Header
  42.   Directory (v0)
  43.   
  44.   For HRFi version 1:
  45.   
  46.   Header
  47.   Directory (v1)
  48.   
  49.   For HRFi version 2:
  50.   
  51.   Header
  52.   Information
  53.   Directory (v2)
  54.  
  55.  
  56.   Header of the file:
  57.   -------------------
  58.   
  59.   ID As String * 5            ' "HRFi"+chr(26)
  60.   Version As Byte             ' 0 = Version 0 (No name change support)
  61.                               ' 1 = Version 1 (Default)
  62.                               ' 2 = Version 2 (Recommended)
  63.   Filename As String * 98     ' Name of the companion file (ex: Example.Dat)
  64.   FileSize As Long            ' Size of the companion file
  65.   HRipVer As Version          ' 0.0 = Build 32 to 37 (v2.1 Beta or below)
  66.                               ' 3.0 = Build 38       (v3.0 Beta)
  67.                               ' 3.1 = Build 39       (v3.1 Beta)
  68.                               ' 3.2 = Build 40 to 41 (v3.2 Beta)
  69.                               ' 3.3 = Build 42       (v3.3 Beta)
  70.                               ' 3.5 = Build 47       (v3.5 Beta)
  71.                               ' 4.0 = Build 71       (v4.0)
  72.                               ' 4.1 = Build 72       (v4.1)
  73.                               ' 4.2 = Build 74       (v4.2)
  74.                               ' If Version is 2 then HRipVer is at least 4.2
  75.   DirNum As Long              ' Number of entries in file
  76.  
  77.   The Version number define how the rest of file will be
  78.   (see Global File Format). Go to the appropriate chapter to see the rest of the
  79.   format.
  80.   
  81.   The HRipVer number define which version of the HyperRipper created the file
  82.   and so which file types may appear in the Directory.
  83.   
  84.   
  85.   Directory v0 (HRFi version 0):
  86.   ------------------------------
  87.  
  88.   The following structure is repeated DirNum times (see Header):
  89.  
  90.   FileType As Byte            ' File Type (See File Types chapter)
  91.   Offset As Long              ' Offset in companion file
  92.   Size As Long                ' Size in companion file
  93.   
  94.   
  95.   Directory v1 (HRFi version 1):
  96.   ------------------------------
  97.  
  98.   The following structure is repeated DirNum times (see Header):
  99.  
  100.   Filename As String * 32     ' File name without extension (ex: Arena)
  101.                               ' If FileType = 199 then the Filename can have
  102.                               ' an extension (ex: Arena.txt)
  103.   FileType As Byte            ' File Type (See File Types chapter)
  104.   Offset As Long              ' Offset in companion file
  105.   Size As Long                ' Size in companion file
  106.   
  107.   
  108.   Information (HRFi version 2):
  109.   -----------------------------
  110.   
  111.   This structure appear ONLY in HRFi files version 2 after header and before
  112.   the Directory:
  113.  
  114.   InfoVer As Byte             ' Version of Information chunk
  115.                               ' 0 = 2 bytes Information chunk
  116.                               '     (only SecuritySize is present)
  117.                               ' 1 = 256 bytes Information chunk
  118.   SecuritySize As Byte        ' Max Size of Security Data in Directory v2
  119.                               ' Allowed values:
  120.                               ' 0 (Disable),1,2,4,8 and 16
  121.   Author As String * 64       ' Name/Email of Author
  122.   URL As String * 128         ' URL
  123.   Title As String * 64        ' Title
  124.   
  125.   
  126.   Directory v2 (HRFi version 2):
  127.   ------------------------------
  128.  
  129.   The following structure is repeated DirNum times (see Header):
  130.  
  131.   Filename As String * 64     ' File name without extension (ex: Arena)
  132.                               ' If FileType = 199 then the Filename can have
  133.                               ' an extension (ex: Arena.txt)
  134.   FileType As Byte            ' File Type (See File Types chapter)
  135.   Offset As Long              ' Offset in companion file
  136.   Size As Long                ' Size in companion file
  137.   Security As String * 16     ' Security Data of companion file
  138.                               ' Bit of source companion file at Offset and of
  139.                               ' SecuritySize size in bytes.
  140.  
  141.  
  142.   File Types:
  143.   -----------
  144.   
  145.   ###  HRipVer  Description                   Extension      v0   v1   v2
  146.     0      0.0  Raw Data                      .RAW           Yes  Yes  Yes
  147.     1      0.0  Windows BitMaP                .BMP           Yes  Yes  Yes
  148.     2      0.0  Interchange File Format       .IFF           Yes  Yes  Yes
  149.     3      0.0  Portable Network Graphic      .PNG           Yes  Yes  Yes
  150.     4      3.0  Graphics Interchange Format   .GIF           Yes  Yes  Yes
  151.     5      3.1  Windows MetaFile              .WMF           Yes  Yes  Yes
  152.     6      3.1  Windows Enhanced MetaFile     .EMF           Yes  Yes  Yes
  153.     7      3.2  JPEG                          .JPG           Yes  Yes  Yes
  154.   100      0.0  MIDI v1.0                     .MID           Yes  Yes  Yes
  155.   101      0.0  Creative VOiCe file           .VOC           Yes  Yes  Yes
  156.   102      0.0  RIFF/WAVE                     .WAV           Yes  Yes  Yes
  157.   103      4.0  UNIT 669 Module               .669           Yes  Yes  Yes
  158.   104      4.0  FastTracker Extended Module   .XM            Yes  Yes  Yes
  159.   105      4.2  ImpulseTracker Module         .IT            Yes  Yes  Yes
  160.   106      4.2  ScreamTracker Module          .S3M           Yes  Yes  Yes
  161.   111     *0.0! MPEG Audio Layer 1            .MP1           Yes  Yes  Yes
  162.   112     *0.0! MPEG Audio Layer 2            .MP2           Yes  Yes  Yes
  163.   113     *0.0! MPEG Audio Layer 3            .MP3           Yes  Yes  Yes
  164.   199   ***3.3! Unknown file type             (None)         No   Yes  Yes
  165.   200    **0.0! RIFF/AVI                      .AVI           Yes  Yes  Yes
  166.   201    **0.0! Quicktime MOVie               .MOV           Yes  Yes  Yes
  167.   202      3.3  Autodesk Animator FLIC        .FLI           Yes  Yes  Yes
  168.   203      3.3  EGI/DTA FLIC                  .FLC           Yes  Yes  Yes
  169.   204      3.5  Bink Video                    .BIK           Yes  Yes  Yes
  170.  
  171.   v0 = Is the file type supported by version 0 HRF files ?
  172.   v1 = Is the file type supported by version 1 HRF files ?
  173.   v2 = Is the file type supported by version 2 HRF files ?
  174.    ! = HRipVer is not set correctly in on or more versions
  175.  
  176.   Needed Dragon UnPACKer versions:
  177.    v0.0 -> Dragon UnPACKer v4.00.32 Beta
  178.       * -> Dragon UnPACKer v4.00.35 Beta
  179.      ** -> Dragon UnPACKer v4.00.37 Beta
  180.    v3.0 -> Dragon UnPACKer v4.00.38 Beta
  181.    v3.1 -> Dragon UnPACKer v4.00 RC1
  182.    v3.2 -> Dragon UnPACKer v4.00 RC2
  183.    v3.3 -> Dragon UnPACKer v4.00 Final
  184.     *** -> Dragon UnPACKer v4.01.43 Beta
  185.    v3.5 -> Dragon UnPACKer v4.01.47
  186.    v4.0 -> Dragon UnPACKer v4.13.72
  187.    v4.2 -> Dragon UnPACKer v4.13.74
  188.    
  189.   Version 4.00.35 Beta to 4.00.37 Beta did not set correctly the HRipVer in the
  190.   Header so it was still v0.0 but new file formats were supported. I think, if
  191.   you plan to create/edit .HRF files you should set the HRipVer to at least
  192.   v3.0 if you plan to use * or ** file types.
  193.   Version 4.01.43 Beta to 4.01.46 Beta did not set correctly the HRipVer in the
  194.   Header so it was still v3.3 but new file formats were supported. If you plan
  195.   to use type 199 you should set HRipVer to at least v3.5.
  196.   
  197.   File types from   1 to  90 are for still images (graphics files).
  198.   File types from  91 to  99 are reserved for testing purposes.
  199.   File types from 100 to 190 are for music/sound files.
  200.   File types from 191 to 199 are reserved.
  201.   File types from 200 to 255 are for other files.
  202.   
  203.   You can contact me (see end of chapter) if you want to reserve a file type.
  204.   If you reserve a file type it will be supported in the next Dragon UnPACKer
  205.   version.
  206.  
  207.  
  208.   Contact
  209.   -------
  210.  
  211. If there is something I don't explained well please contact me.
  212. If there is something wrong in MY specs of MY format please ask also!! :)
  213.  
  214. Dragon Software is available on the internet at:
  215. http://www.drgsoft.com/dup4/
  216.  
  217. You can reach Alex Devilliers:
  218.  
  219.  By E-Mail: support@drgsoft.com
  220.     By ICQ: 1535372 (Elbereth)
  221.  
  222.  
  223.   What's new?
  224.   -----------
  225.  
  226. Release A: First version ever.
  227. Release B: Added file types 5 (WMF) and 6 (EMF).
  228. Release C: Added file type 7 (JPG).
  229. Release D: Some more explanation.. :)
  230. Release E: Added file types 202 (FLI) and 203 (FLC).
  231. Release F: Added file type 199 (File without extension).
  232. Release G: Added file type 204 (BIK).
  233. Release H: Changed URL and Email in Contact chapter.
  234.            Introduced HRF v2 (currently unsupported in DUP4).
  235. Release I: Added file type 103 (669), 104 (XM), 105 (IT) and 106 (S3M).
  236.            Corrected HRF v2 (now supported by DUP4).
  237.  
  238. ===============================================================================
  239.